<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Database Caching Class : CodeIgniter User Guide</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv='expires' content='-1' />
<meta http-equiv= 'pragma' content='no-cache' />
<meta name='robots' content='all' />
<meta name='author' content='ExpressionEngine Dev Team' />
<meta name='description' content='CodeIgniter User Guide' />

<style type="text/css">
<!--
.style1 {
	color: #006600;
	font-weight: bold;
}
-->
</style>
</head>
<body>

<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Toggle Table of Contents" alt="Toggle Table of Contents" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>CodeIgniter User Guide Version 2.0.3</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">Table of Contents Page</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.com/">CodeIgniter Home</a> &nbsp;&#8250;&nbsp;
<a href="../index.html">User Guide Home</a> &nbsp;&#8250;&nbsp;
<a href="index.html">Database Library</a> &nbsp;&#8250;&nbsp;
Database Caching Class
</td>
<td id="searchbox"><form method="get" action="http://www.google.com/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.com/user_guide/" />Search User Guide&nbsp; <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />&nbsp;<input type="submit" class="submit" name="sa" value="Go" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->


<br clear="all" />


<!-- START CONTENT -->
<div id="content">

<h1>쿼리 캐시 Database Caching Class</h1>

<p>데이터베이스 캐싱 클래스는 쿼리를 텍스트파일로 캐싱하도록 하여 데이터베이스의 부하(load)를 줄일수 있도록 합니다.</p>

<p class="important"><strong>중요:</strong>&nbsp; 캐싱이 활성화 되어있다면 이 클래스는 데이터베이스 드라이버에 의해 자동으로 초기화 됩니다. 절대 이클래스를 직접 로드 하지 마세요.<br />
<br />

<strong>부가사항:</strong>&nbsp; 모든 쿼리 결과 함수가 캐싱가능한 것은 아닙니다. 이 페이지를 주의 깊게 보셔야 합니다.</p>

<h2>캐시 활성화 Enabling Caching</h2>

<p>캐시는 아래와 같이 3단계를 통해서 활성화 할수 있습니다:</p>

<ul>
<li>캐시 파일이 저장될 디렉토리를 만들고 , 쓰기 가능하도록 합니다.</li>
<li>캐시 디렉토리의 경로를 <dfn>application/config/database.php</dfn> 파일 안에 설정합니다.</li>
<li>캐시를 활성화합니다.<dfn>application/config/database.php</dfn> 파일을 통해 전역적으로 활성화 하거나 ,아래 기술된 방법을 통해 수동으로 활성화 합니다..</li>
</ul>

<p>일단 활성화 되면, 데이터베이스 쿼리가 포함된 페이지가 로드될때마다 자동으로 캐싱이 이루어집니다.</p>


<h2>캐시는 어떻게 작동하는가 (How Does Caching Work)?</h2>

<p>캐시는 페이지가 보여질때마다 동적으로 작동합니다.
캐시가 활성화 되었을때, 웹페이지가 맨처음 로드되면, 쿼리결과 객체는 직렬화(serialize) 되어 서버에 텍스트 파일로 저장됩니다. 두번째로 페이지가 로드 되면 데이터베이스로 접근하는대신에 캐시파일이 사용됩니다.  이미 캐시된 페이지에 대해서는 데이터베이스 사용률이 제로에 가까울정도로 줄어듭니다.</p>

<p>오직 <span class="style1">읽어오는</span> (SELECT) 쿼리만이 캐시될수 있습니다. 왜냐하면 읽어오는쿼리만 결과셋을 생성하기 때문이죠 .<dfn>쓰는형식</dfn> (INSERT, UPDATE, etc.) 는 결과셋을 생성하지 않기 때문에 캐시되지 않습니다.</p>

<p>캐시파일은 종료기간이 없습니다.(스스로 제거되지않습니다).  여러분이 직접 제거하기전까지는 캐시된 채로 남아있습니다. 캐시시스템은 각페이지에 관련된 캐시파일을 지우거나 전체 캐시파일을 지울수 있도록 해줍니다.
일반적으로 , 데이터베이스에 새로운 정보를 삽입한다든지하는 특정 이벤트 발생시 관리함수가 캐시를 지우도록 하고싶으실 겁니다.이에대해서는 아래에 설명합니다.</p>

<h2>캐시가 사이트의 성능을 올려줄것인가(Will Caching Improve Your Site's Performance)?</h2>

<p>캐시를통한 성능이득을 얻는것은 여러요소에 의해 좌우됩니다.
여러분이 굉장히 최적화가 잘되어있으며 부하가 매우적은 데이터베이스를 사용하신다면 성능향상은 미미할것입니다.
만약 부하가 매우 높은 데이터베이스를 사용한다면, 파일시스템의 부하가 너무높지않다고 가정할때 응답성능이 향상되는것을 느끼실수 있을것 입니다.  반드시 기억해야할것은 , 캐싱은 단순히 정보의 소스를 데이터베이스에서 파일시스템으로 바꾸어준다는것입니다.</p>

<p>에를들어 어떤 클러스터 서버 환경에서는 파일시스템이 혹사당하기 때문에 캐싱은  오히려 해로울수도 있습니다. 공용으로 사용하는 단일 서버환경에서는 ,캐싱이 효과적일것입니다.불행하게도, 데이터베이스를 캐시해야하는지 말아야하는지에 대해 간단히 말할수 없군요 . 그건 여러분의 상황에 달린것이니까요.</p>

<h2>캐시파일은 어떻게 저장되는가 (How are Cache Files Stored)?</h2>

<p>CodeIgniter는  쿼리의 결과를 각각의 고유한 캐시파일에 저장합니다.캐시파일의 묶음은 여러분의 컨트롤러 함수에 대응하여 나중에 하위폴더로 구성됩니다.  정확하게 말하면, 하위폴더의 이름은 URI 의 첫 두 세그먼트의와 동일합니다(하나는 컨트롤러 클래스의 이름 다른하나는 함수의 이름이 되겠지요).</p>

<p>예를들어 , 컨트롤러 클래스의 이름이 <dfn>blog</dfn> 이며 3개의 쿼리가 포함된 <dfn>comments</dfn> 함수를 호출한다고 합시다.  캐싱시스템은<kbd>blog+comments</kbd>라는 이름의 하위폴더를 생성하고 3개의 캐시파일을 그안에 생성합니다.</p>

<p>만약 페이지번호 등 URI를 통해 전달되는 정보와 결합하여 동적으로 쿼리를 생성하는경우라면 , 각 쿼리별로 고유한 캐시파일이 생성됩니다.  쿼리대신에 캐시파일을 더 많이 사용하는것이 손해일 경우도 있습니다. </p>


<h2>캐시파일의 관리 (Managing your Cache Files)</h2>

<p>캐시파일이 자동으로 삭제되지 않기 때문에 , 프로그램 내에서 삭제하는 루틴을 만들 필요가 있습니다. 예를들어 , 여러분이 사용자가 글을 쓸수 있는 블로그를 운영한다고 합시다.  새로운 글이 등록될 때마다 , 캐시파일을 지우고싶으실 거예요 .  아래에 설명하는 두가지 삭제함수가 데이터를 지우는데 도움이 될거예요.</p>


<h2>어떤 함수들은 캐시시스템에서 작동하지 않음( Not All Database Functions Work with Caching)</h2>

<p>마지막으로, 캐시된 결과객체는 실재 객체의 단순버전이라는것을 말씀드립니다. 그 이유로,
몇몇 쿼리결과함수는 사용할수 없습니다.</p>

<p>아래함수들은 캐시된 결과객체에서는 작동하지 않습니다:</p>

<ul>
<li>num_fields()</li>
<li>field_names()</li>
<li>field_data()</li>
<li>free_result()</li>
</ul>

<p>또한, 두개의 데이터베이스 리소스(result_id ,conn_id) 는 사용할수 없습니다. 왜냐하면, 그 리소스들은 런타임 작동(run-time operation)의 부산물이기 때문입니다.</p>


<br />

<h1>함수 레퍼런스 Function Reference</h1>



<h2>$this->db->cache_on()&nbsp; / &nbsp; $this->db->cache_off()</h2>

<p>수동으로 캐시를 활성/비활성화 합니다.  이함수들은 캐시로부터 특정 쿼리를 배제하고싶을때 유용합니다(특정쿼리를 캐시하지 않고자할때).</p>
<p>예제:</p>
<code>
// Turn caching on<br />
$this->db->cache_on();<br />
$query = $this->db->query("SELECT * FROM mytable");<br />
<br />
// Turn caching off for this one query<br />
$this->db->cache_off();<br />
$query = $this->db->query("SELECT * FROM members WHERE member_id = '$current_user'");<br />
<br />
// Turn caching back on<br />
$this->db->cache_on();<br />
$query = $this->db->query("SELECT * FROM another_table");
</code>


<h2>$this->db->cache_delete()</h2>

<p>특정페이지에 관련된 캐시파일을 지웁니다.이함수는 데이터베이스 업데이트후 캐시파일을 지우고자할때 유용합니다.</p>

<p>캐싱 시스템은 여러분이 보고있는 페이지의 URI에 대응되도록 캐시파일을 저장합니다. 예를들어<dfn>example.com/index.php/blog/comments</dfn>, 페이지를 보고있다면 캐싱시스템은 캐시파일을 <dfn>blog+comments</dfn>폴더에 저장합니다. 이 특정 캐시파일을 지우려면 아래와같이 합니다:</p>

<code>$this->db->cache_delete('blog', 'comments');</code>

<p>파라미터로 아무것도 주어지지않는다면, 함수는 현재 URI 를 참조하여 대응되는 캐시파일을 지웁니다.</p>


<h2>$this->db->cache_delete_all()</h2>

<p>현재 존재하는 모든 캐시파일을 지웁니다. 사용예:</p>

<code>$this->db->cache_delete_all();</code>










</div>
<!-- END CONTENT -->


<div id="footer">
<p>
Previous Topic:&nbsp;&nbsp;<a href="call_function.html">Custom Function Calls</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">Top of Page</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">User Guide Home</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
Next Topic:&nbsp;&nbsp;<a href="forge.html">Database manipulation with Database Forge</a>
</p>
<p><a href="http://codeigniter.com">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">Ellislab, Inc.</a></p>
</div>

</body>
</html>